The upgrade utility is run from the command line using the following syntax:
asupgrade [--console ] [--version ] [--help ] [--source applicationserver_7.x/8.x_installation] [--target applicationserver_8.2_installation] [--domain domain_name] [--adminuser admin_user] [--adminpassword admin_password] [--masterpassword master_password] [--targetnsspwdfile targetNSS_password_filepath] [--nsspwdfile NSS_password_filepath] [--jkspwdfile JKS_password_filepath] [--capwdfile CA_password_filepath] [--clinstancefiles file1 [, file2, file3, ... filen]]
The following table describes the command options in greater detail, including the short form, the long form, and a description.
Table 2–2 asupgrade Utility Command Options
Short Form |
Long Form |
Description |
---|---|---|
-c |
--console |
Launches the upgrade command line utility. |
-V |
--version |
The version of the Upgrade Tool. |
-h or -? |
--help |
Displays the arguments for launching the upgrade utility. |
-t |
--target |
The domains root directory of the Application Server 8.2 EE installation. |
-s |
--source |
The installation directory when source is Application Server 7.x. Domains root directory when the source is Application Server 8.x and an in-place upgrade is done. Domain directory domain-dir when the source is Application Server 8.x and a side-by-side upgrade is done. |
-d |
--domain |
The domain name for the migrated certificates. |
-a |
--adminuser |
The user name of the admin user |
-w |
--adminpassword |
The admin password |
-m |
--masterpassword |
Master password |
-n |
--nsspwdfile |
The path to the NSS password file. This file is a plain text file that contains only the password |
-e |
--targetnsspwdfile |
The path to the target NSS password file. This file is a plain text file that contains only the password |
-j |
--jkspwdfile |
The path to the JKS password file. This file is a plain text file that contains only the password |
-p |
--capwdfile |
The path to the CA certificate password file. This file is a plain text file that contains only the password. |
-i |
--clinstancefiles |
The path to the cluster file, if the source installation is Application Server 7.x. The default filename is $AS_INSTALL/conf/clinstance.conf. |
The following examples show how to use the asupgrade command-line utility to upgrade an existing application server installation to Application Server 8.2.
Example 1: Upgrading an Application Server 7 Installation to Application Server 8.2 EE with Prompts for Certificate Migration.
This example shows how to perform a side-by-side upgrade of a Sun Java SystemApplication Server 7 installation to Sun Java System Application Server 8.2. This command prompts you to migrate certificates. If you reply no, certificates are not migrated.
asupgrade --source /home/sunas7 --target /home/sjsas8.2/domains
Example 2: Upgrading an Application Server 7.1 EE Installation with Clusters and NSS Certificates to Application Server 8.2 EE
This example shows how to upgrade (side-by-side) a Sun Java System Application Server 7.1 EE installation with a cluster to Sun Java System Application Server 8.2 EE. NSS certificates will be migrated, as will the clinstance.conf cluster file.
asupgrade --source /home/sjsas7.1 --target /home/sjsas8.2/domains --domain domain1 --nsspwdfile /home/sjsas7.1/nsspassword.txt --targetnsspwdfile /home/sjsas8.2/nsspassword.txt --clinstancefiles /home/sjsas7.1/config/clinstance.conf
After upgrade, node agents for all remote instances are created on the target DAS. These node agents have to copied to the respective host systems and started. For more information, refer To Upgrade a Node Agent from Application Server 7.x EE
Example 3: Upgrading an Application Server 8.1 EE Installation (in-place) with Clusters and NSS Certificates to Application Server 8.2 EE
This example shows how to perform an in-place upgrade of a Sun Java System Application Server 8.1 EE installation with a cluster to Sun Java System Application Server 8.2 EE. NSS certificates will be migrated, as will the clinstance.conf cluster file.
asupgrade --source /home/sjsas8.1/domains --target /home/sjsas8.2/domains --domain domain1 --nsspwdfile /home/sjsas8.1/nsspassword.txt --targetnsspwdfile /home/sjsas8.2/nsspassword.txt --clinstancefiles /home/sjsas8.1/config/clinstance.conf
After upgrade, node agents for all remote instances are created on the target DAS. These node agents have to copied to the respective host systems and started. For more information, refer To Upgrade a Node Agent from Application Server 8.1 EE
Example 4: Upgrading an Application Server 8.1 EE Installation (side—by—side) with Clusters and NSS Certificates to Application Server 8.2 EE
This example shows how to perform a side-by-side upgrade of a Sun Java System Application Server 8.1 EE installation with a cluster to Sun Java System Application Server 8.2 EE. NSS certificates will be migrated, as will the clinstance.conf cluster file.
asupgrade --source /home/sjsas8.1/domains/domain1 --target /home/sjsas8.2/domains --domain domain1 --nsspwdfile /home/sjsas8.1/nsspassword.txt --targetnsspwdfile /home/sjsas8.2/nsspassword.txt --clinstancefiles /home/sjsas8.1/config/clinstance.conf