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