Sun Java System Application Server Enterprise Edition 8.2 Upgrade and Migration Guide

Upgrading from the Command Line

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

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