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:
 
- 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.
- 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. 
- 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.
- 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.
- From the Transfer Security Certificates screen , press the Add Domain 
    button to add domains with certificates to be transferred. The 
    Add Domain dialog displays.
- From the Add Domain dialog, select the domain name that contains the 
    security certificates to migrate and enter the appropriate passwords.
- Click the OK button when done. The Transfer Security Certificates screen
    will be redisplayed. 
- Repeat Step 5 and Step 6 until 
    all the domains that have certificates to be transferred have been added. 
- 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.
- 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.
- 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.
- The Upgrade Results screen displays, 
    showing the status of the upgrade operation in the Results field. 
- Click the Finish button to close the Upgrade Tool when the upgrade process 
    is complete. 
Legal Notices