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