Sun GlassFish Enterprise Server v2.1.1 Upgrade Guide

Upgrading 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. Do not run the asupgrade utility if you are upgrading from Sun Java System Application Server 9.x.

For upgrading your 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:

[--console ] 
[--version ] 
[--help ] 
[--source applicationserver_installation_domaindirectory] 
[--target enterpriseserver_v2.1.1_installation] 
[--adminuser enterpriseserver_v2.1.1_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  




Launches the upgrade command line utility. 

-v or -V 


The version of the Upgrade Tool. 



Displays the arguments for launching the upgrade utility. 



The domains directory of the Application Server 9.1 Update 1 installation. 



The installation directory of the older Application Server installation. 



The admin user for the source server.  



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 Enterprise Server v2.1.1.

This example shows how to perform a side-by-side upgrade of a Sun GlassFishApplication Server 8.x installation to Enterprise Server v2.1.1.

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

ProcedureTo 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 Enterprise Server installation process, the Upgrade Wizard screen automatically displays after the installation completes.

  1. 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, as-install/domains/domain1

  2. In the Target Installation Directory field, enter the location of the Enterprise 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.

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

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

  5. 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.