Use the asupgrade utility to migrate the server configration
and its persisted state, J2EE services, and deployed J2EE applications. The
configuration of an installed Sun Java System Application Server 7 is migrated
to the Sun Java System Application Server 8 Application Server installation.
If the domain contains information about a deployed application
and the installed application components do not agree with the configuration
information, the configuration is migrated as is without any attempt to reconfigure
the incorrect configurations.
asupgrade migrates the configuration and deployed
applications of a previous version of the Application Server; however, the
runtime binaries of the server are not updated. Database migrations or conversions
are also beyond the scope of the asupgrade command.
Only those instances that do not use the Sun Java System Web Server-specific
features will be upgraded seamlessly. Configration files related to HTTP path,
CGI bin, SHTML, and NSAPI plugins will not be upgraded.
The upgrade process can also be initiated automatically at installation
time using the Upgrade checkbox in the Application Server installer. After
completion of the upgrade, use the Application Server Uninstaller to remove
the previous version of the Application Server.
Application archives (EAR files) and component archives (JAR, WAR, and
RAR files) that are deployed in the Application Server 7.x/8.0 environment
do not require any modification to run on Application Server 8.1. Applications
and components that are deployed in the source server are deployed on the
target server during the upgrade. Applications that do not deploy successfully
on the target server must be migrated using the Migration Tool (asmigrate), then manually redeployed.
You must specify the source and target directories for the upgrade.
If the upgrade includes certificates, you must also provide the passwords
for the source PKCS12 file and the target JKS keyfile for each domain that
contains certificates to be migrated. Since Application Server 7 uses a different
certificate store format (NSS) than Application Server 8 (JSSE), the migration
keys and certificates are converted to the new format. Upon successful upgrade,
an upgrade report is generated listing successfully migrated items along with
a list of the items that could not be migrated.
If you issue the asupgrade command with no options,
the Upgrade Tool GUI will be displayed. If you use the asupgrade command in console mode and don't supply all of the required information,
you will be interviewed for any required options that you omitted.
Example 1. Using asupgrade
This example shows how to upgrade a Sun Java System Application Server
7 installation to Sun Java System Application Server 8.1. You will be prompted
to migrate certificates. If you reply no, then no certificates will be migrated.
example% asupgrade --adminuser admin
--adminpassword adminadmin --masterpassword changeit
--source /home/sunas7 --target /home/sjsas8.1
This example shows how to upgrade a Sun Java System Application Server
7.1 EE installation to Sun Java System Application Server 8.1 EE. NSS certificates
will be migrated.
example% asupgrade --adminuser admin
--adminpassword adminadmin --masterpassword changeit
--source /home/sjsas7.1 --target /home/sjsas8.1
--domain domain1 --nsspwdfile /home/sjsas7.1/nsspassword.txt
--targetnsspwdfile /home/sjsas8.1/nsspassword.txt
This example shows how to upgrade a Sun Java System Application Server
7.0 PE installation to Sun Java System Application Server 8.1 PE. The NSS
certificates from the 7.0 PE source server will be converted to JKS and CA
certificates in the 8.1 PE target server.
example% asupgrade --adminuser admin
--adminpassword adminadmin --password changeit
--source /home/sjsas7.0 --target /home/sjsas8.1
--domain domain1 --nsspwdfile /home/sjsas7.0/nsspassword.txt
--jkspwdfile /home/sjsas7.0/jkspassword.txt
--capwdfile /home/sjsas7.0/capassword.txt
This example shows how to upgrade a Sun Java System Application Server
8.0 PE installation to Sun Java System Application Server 8.1 PE. JKS and
CA certificates will be migrated.
example% asupgrade --adminuser admin
--adminpassword adminadmin --masterpassword changeit
--source /home/sjsas8.0 --target /home/sjsas8.1
--domain domain1 --jkspwdfile /home/sjsas8.0/jkspassword.txt
--capwdfile /home/sjsas8.1/capassword.txt