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

Upgrading Through the Upgrade Utility

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] 
--adminuser admin_user 
[--adminpassword admin_password] 
[--masterpassword changeit] 
[--passwordfile path_to_password_file] 
[--domain domain_name] 
[--nsspwdfile NSS_password_filepath] 
[--targetnsspwdfile target_NSS_password_filepath] 
[--jkspwdfile JKS_password_filepath] 
[--capwdfile CA_password_filepath] 
[--clinstancefile 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 3–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`	`---help`	Displays the arguments for launching the upgrade utility.
`-t`	`---target`	The installation directory for Application Server 8.2.
`-a`	`---adminuser`	The username of the administrator.
`-w`	`---adminpassword`	The password for the `adminuser`. Although this option can be used, the recommended way to transmit passwords is by using the `-passwordfile` option.
`-m`	`--masterpassword`	The master password that is created during installation. The default value is `changeit`. Although this option can be used, the recommended way to transmit passwords is by using the --passwordfile option. Note: This option is required only if your target server is Application Server 8.2 EE.
`-f`	`--passwordfile`	The path to the file that contains the `adminpassword` and `masterpassword`. Content of this file should be in the following format: `AS_ADMIN_ADMINPASSWORD=adminpassword` `AS_ADMIN_MASTERPASSWORD=masterpassword`
`-d`	`--domain`	The domain name for the migrated certificates.
-n	`--nsspwdfile`	The path to the NSS password file.
`-e`	`--targetnsspwdfile`	The path to the target NSS password file.
-j	`--jkspwdfile`	The path to the JKS password file.
`-p`	`--capwdfile`	The path to the CA certificate password file.
`-i`	`--clinstancefile`	The path to the cluster file. 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 with Prompts for Certificate Migration.

This example shows how to upgrade a Application Server 7 installation to Application Server 8.2. This command prompts you to migrate certificates. If you reply no, then no certificates are migrated.

asupgrade --adminuser admin --passwordfile password.txt
 --source /home/sunas7 --target /home/sjsas8.2

Example 3: Upgrading an Application Server 7 PE Installation with NSS Certificates to Application Server 8.2 PE

This example shows how to upgrade a Application Server 7 PE installation toApplication Server 8.2 PE. The NSS certificates from the 7.0 PE source server are converted to JKS and CA certificates in the8.2 PE target server.

asupgrade --adminuser admin --passwordfile password.txt 
--source /home/sjsas7.0 
--target /home/sjsas8.2 
--domain domain1 
--nsspwdfile /home/sjsas7.0/nsspassword.txt 
--jkspwdfile /home/sjsas7.0/jkspassword.txt 
--capwdfile /home/sjsas7.0/capassword.txt

Example 4: Upgrading an Application Server 8.0 PE Installation with JKS and CA Certificates to Application Server 8.2 PE

This example shows how to upgrade a Application Server 8.0 PE installation to Application Server 8.2 PE. JKS and CA certificates will be migrated.

asupgrade --adminuser admin --passwordfile password.txt 
--source /home/sjsas8.0 
--target /home/sjsas8.2 
--domain domain1 
--jkspwdfile /home/sjsas8.0/jkspassword.txt 
--capwdfile /home/sjsas8.2/capassword.txt