Performing an In-Place Upgrade With the Update Center Tools

This section explains how to use the three Update Center tools to perform an in-place upgrade to GlassFish Server 3.1 from GlassFish Server 3.0.1 or Enterprise Server v3. Specifically, the three tools explained in this section are:

• Update Tool

• Software Update Notifier

• The pkg command-line utility

The following topics are addressed here:

• Update Center Tool Procedures

• To Upgrade Using the Update Tool GUI

• To Upgrade Using the Software Update Notifier

• To Upgrade From the Command Line Using the pkg Utility

Update Center Tool Procedures

Unlike when using Upgrade Tool, when you use the Update Tool, the Software Update Notifier, or the pkg utility to perform a GlassFish Server 3.1 upgrade, the older source server directories are overwritten with the new target server directories, and the existing configuration and deployed applications are reused in the updated installation.

To perform the upgrade, the user who runs the upgrade needs to have read and writer permissions for the server installation directories.

You can perform an upgrade using the Update Center tools in the following ways:

• To Upgrade Using the Update Tool GUI

• To Upgrade Using the Software Update Notifier

• To Upgrade From the Command Line Using the pkg Utility

To Upgrade Using the Update Tool GUI

This procedure explains how to use the graphical Update Tool to perform an in-place upgrade to GlassFish Server 3.1 from GlassFish Server 3.0.1 or Enterprise Server v3. Note that it is not possible to use this procedure with any other product releases.

1. Ensure that all domains on the source server from which you are upgrading are stopped before proceeding.
2. In a command shell for your operating environment, navigate to the as-install-parent/bin directory.
3. Use the updatetool command to start the Update Tool GUI.

   The Update Tool main window is displayed.

4. Click on Available Updates.
5. Select all items in the Available Updates list, and then click the Install button in the toolbar at the top of the Update Tool main window.

   When the upgrade is complete, exit Update Tool.

6. Upgrade the domain by starting the DAS with the --upgrade option.

   as-install-parent/glassfish/bin/asadmin start-domain --upgrade domain-name

   This upgrades the domain and then shuts down the DAS.

7. Start the DAS normally.

   as-install-parent/glassfish/bin/asadmin start-domain domain-name

Next Steps

• If your older installation was configured with the Load Balancer Plug-in, you will need to download the latest version of the Plug-in Installer and configure it for use with GlassFish Server 3.1. For more information, see Chapter 7, Configuring Web Servers for HTTP Load Balancing, in Oracle GlassFish Server 3.1-3.1.1 High Availability Administration Guide.

• Browse to the URL http://localhost:8080 to view the domain-dir/docroot/index.html file. This file is brought over during the upgrade. You may want to copy the default GlassFish Server 3.1 file from the domain1.original/docroot directory and customize it for your GlassFish Server 3.1 installation.

• To register your installation of GlassFish Server from the Administration Console, select the Registration item from the Common Tasks page. For step-by-step instructions on the registration process, click the Help button on the Administration Console.

To Upgrade Using the Software Update Notifier

This procedure explains how to use the Software Update Notifier to perform an in-place upgrade to GlassFish Server 3.1 from GlassFish Server 3.0.1 or Enterprise Server v3. Note that it is not possible to use this procedure with any other product releases.

Before You Begin

The Software Update Notifier must be installed and enabled on the GlassFish Server or Enterprise Server release from which you are upgrading. Software Update Notifier installation is typically performed during the initial GlassFish Server or Enterprise Server installation. The Software Update Notifier can also be installed later using Update Tool. For more information about the Update Notifier, refer to the Update Tool online help.

1. Wait for the Software Update Notifier to pop up a notification balloon informing you that updates are available.
2. Click the balloon prompt to open the Software Update GUI.
3. Manually stop all domains and server instances.
4. Using the Software Update GUI, select the items you want to upgrade and start the installation.

   Ensure that GlassFish Server 3.1 is one of the items you select for upgrade. This upgrades the server and selected components to the latest available versions.

5. Upgrade the domain by starting the DAS with the --upgrade option.

   as-install-parent/glassfish/bin/asadmin start-domain --upgrade domain-name

   This upgrades the domain and then shuts down the DAS.

6. Start the DAS normally.

   as-install-parent/glassfish/bin/asadmin start-domain domain-name

Next Steps

• If your older installation was configured with the Load Balancer Plug-in, you will need to download the latest version of the Plug-in Installer and configure it for use with GlassFish Server 3.1. For more information, see Chapter 7, Configuring Web Servers for HTTP Load Balancing, in Oracle GlassFish Server 3.1-3.1.1 High Availability Administration Guide.

• Browse to the URL http://localhost:8080 to view the domain-dir/docroot/index.html file. This file is brought over during the upgrade. You may want to copy the default GlassFish Server 3.1 file from the domain1.original/docroot directory and customize it for your GlassFish Server 3.1 installation.

• To register your installation of GlassFish Server from the Administration Console, select the Registration item from the Common Tasks page. For step-by-step instructions on the registration process, click the Help button on the Administration Console.

To Upgrade From the Command Line Using the pkg Utility

This procedure explains how to use the pkg utility to perform an in-place upgrade to GlassFish Server 3.1 from GlassFish Server 3.0.1 or Enterprise Server v3. Note that it is not possible to use this procedure with any other product releases.

1. Ensure that all domains on the source server from which you are upgrading are stopped before proceeding.
2. In a command shell for your operating environment, navigate to the as-install-parent/bin directory.
3. Use the pkg image-update command to update your entire GlassFish Server 3.0.1 or Enterprise Server v3 installation to GlassFish Server 3.1.

   ./pkg image-update

   This upgrades the server components to the latest available versions.

4. Upgrade the domain by starting the DAS with the --upgrade option.

   as-install-parent/glassfish/bin/asadmin start-domain --upgrade domain-name

   This upgrades the domain and then shuts down the DAS.

5. Start the DAS normally.

   as-install-parent/glassfish/bin/asadmin start-domain domain-name

Next Steps

• If your older installation was configured with the Load Balancer Plug-in, you will need to download the latest version of the Plug-in Installer and configure it for use with GlassFish Server 3.1. For more information, see Chapter 7, Configuring Web Servers for HTTP Load Balancing, in Oracle GlassFish Server 3.1-3.1.1 High Availability Administration Guide.

• Browse to the URL http://localhost:8080 to view the domain-dir/docroot/index.html file. This file is brought over during the upgrade. You may want to copy the default GlassFish Server 3.1 file from the domain1.original/docroot directory and customize it for your GlassFish Server 3.1 installation.

• To register your installation of GlassFish Server from the Administration Console, select the Registration item from the Common Tasks page. For step-by-step instructions on the registration process, click the Help button on the Administration Console.