Sun Java System Application Server 9.1 Update 1 Upgrade and Migration Guide

Upgrading Application Server Configuration, Deployed Applications, and Certificate Databases

You cannot perform an upgrade if the source and target server file systems, specifically the domain root file system, are not accessible from the same machine. To perform the upgrade, the user who runs the upgrade needs to have Read permissions for the source and target directories and Write permission for the target directory.

Note –

Ensure that you have stopped all instances, node agents, clusters, and domains in the source Application Server before you start the upgrade process.

For upgrading your Application Server installation you can choose:

To Upgrade From the Command Line

To run Upgrade Tool in command-line mode, use the -c option. You can run the upgrade tool in command-line mode using the following syntax:

asupgrade 
[--console ] 
[--version ] 
[--help ] 
[--source applicationserver_installation_domaindirectory] 
[--target applicationserver_9.1u1_installation] 
[--adminuser applicationserver_9.1u1_admin_user_name]
[--passwordfile passwords.txt]

The following table describes the command options in greater detail, including the short form, the long form, and a description.

Table 2–3 asupgrade Utility Command Options


Short Form	Long Form	Description
-c	--console	Launches the upgrade command line utility.
-v or -V	--version	The version of the Upgrade Tool.
-h	--help	Displays the arguments for launching the upgrade utility.
-t	--target	The domains directory of the Application Server 9.1 Update 1 installation.
-s	--source	The installation directory of the older Application Server installation.
-a	--adminuser	The admin user for the source server.
-f	--passwordfile	The file containing the admin password and the master password.

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

This example shows how to perform a side-by-side upgrade of a Sun Java SystemApplication Server 8.x installation to Application Server 9.1 Update 1.

asupgrade -c --source /home/sunas8.2/domains/domain1 --target /home/sjsas9.1/domains

To Upgrade by Using the Upgrade Tool Wizard

To start the wizard,

- On UNIX, change to the <install_dir>/bin directory and type asupgrade.

- On Windows, double click the asupgrade icon in the <install_dir>/bin directory.

If the Upgrade checkbox was selected during the Application Server installation process, the Upgrade Wizard screen automatically displays after the installation completes.

In the Source Installation Directory field, enter the location of the existing installation from which to import the configuration. Enter the domain directory.

For example, <install-root>/domains/domain1

In the Target Installation Directory field, enter the location of the Application Server installation to which to transfer the configuration. Provide the domains root directory of the target Application Server installation as the input to this field.

Provide the admin user name, the admin password, and master password of the source application server. The target domain is created with these credentials.

The Upgrade Results panel is displayed showing the status of the upgrade operation.

Click the Finish button to close the Upgrade Tool when the upgrade process is complete.

Next Steps

To upgrade node agents, see Upgrading Node Agents. After you complete the upgrade, start the Application Server using the asadmin start-domain command. Log on to the Admin Console. You can register your installation of application server from the Admin Console by clicking Common Tasks -> Registration. For step-by-step instructions on the registration process, click the Help button on the Admin Console.