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

Upgrading Through the Command Line

The upgrade utility is run from the command line using the following syntax:

asupgrade 
[--console ] 
[--version ] 
[--help ] 
[--source applicationserver_8.x_installation] 
[--target applicationserver_9_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] 
]

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.

The following examples show how to use the asupgrade command-line utility to upgrade an existing application server installation to Application Server 9.

Example: Upgrading an Application Server 8.0 installation to Application Server 9 with Prompts for Certificate Migration.

This example shows how to upgrade an Application Server 8.0 installation to Application Server 9. You will be prompted to migrate certificates. If you reply no, then no certificates will be migrated.

asupgrade --adminuser admin --passwordfile password.txt
 --source /home/sunas8.1 --target /home/sjsas9

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

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

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