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.1_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 Sun Java System Application Server 8.1. |
-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.1 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.1.
Example 1: Upgrading an Application Server 7 Installation to Application Server 8.1 with Prompts for Certificate Migration.
This example shows how to upgrade a Sun Java SystemApplication 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.
asupgrade --adminuser admin --passwordfile password.txt --source /home/sunas7 --target /home/sjsas8.1
Example 3: Upgrading an Application Server 7 PE Installation with NSS Certificates to Application Server 8.1 PE
This example shows how to upgrade a Sun Java System Application Server 7 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.
asupgrade --adminuser admin --passwordfile password.txt --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
Example 4: Upgrading an Application Server 8.0 PE Installation with JKS and CA Certificates to Application Server 8.1 PE
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.
asupgrade --adminuser admin --passwordfile password.txt --source /home/sjsas8.0 --target /home/sjsas8.1 --domain domain1 --jkspwdfile /home/sjsas8.0/jkspassword.txt --capwdfile /home/sjsas8.1/capassword.txt