Getting Started with the Update Center

[

Unknown macro: {TableOfContents title=' '}

|(TableOfContentstitle='')]

The Update Center is an open source project integrated with GlassFish v3 and Java EE 6 SDK. It provides both the ability to seamlessly apply updates to already installed content and to download and install additional applications.
Cannot resolve external resource into attachment.

Using the Update Center

Before you can use the Update Center, you must have GlassFish v3 or Java EE 6 SDK installed. Download the distribution you want from the GlassFish v3 Download Website.

To launch the Updatetool:

  • From the GlassFish installation directory, navigate to the top level bin directory (<code><GlassFish_v3_Install_Dir>/bin</code>).
  • Launch the Update Tool by typing: <code>updatetool</code>.
    • If the Updatetool client installation option was deselected in installer, or if you installed zip file distribution, the script may need to download and install the necessary runtime packages the first time you invoke it. User will need to run the script again after the bootstrap. Note that the bootstrap may take a while to download and initialize the packages, depending on your connection speed.
  • The Updatetool GUI client displays.

Cannot resolve external resource into attachment.

Setting Up Proxy Configuration

If there are no components listed on the screen of Available Add-ons, you may be behind a proxy server. To connect the Update Center to the proxy server:

  • Select the Preferences button.
  • Select the "Manual proxy configuration" option.
  • Provide the proxy server names and port numbers.
  • If the proxy server requires authentication, select the "Proxy require authentication" checkbox and provide the username and password.
  • Select OK button.

Cannot resolve external resource into attachment.
Select the Available Add-ons node once again to display the components that are available for an update.
If you select a package and install it, the installed package is no longer displayed in Available Add-ons screen. You can view these newly installed components in the Installed Components screen.

Available Add-ons

The Available Add-ons screen shows all the software components available for installation through the Update Center. Notice that the modules are categorized in associated groupings. The Package Details section of the window shows more information about the software package.

Available Updates

The Available Updates screen shows when updates are available for installation. It shows the basic details about each software updates. You can select the desired package(s) from the table and click Install button. The Package Details section of the window shows more information for the component selected in the table.

Installed Components

The Installed Components screen shows the software components currently installed. The Package Details section of the window shows more information for the installed software including technical specifications, documentation, and other useful resources.

Preferences

When you click on the Preferences button, the Preferences dialog will appear. It lets you configure the Update Center settings and specify a schedule for the updates.

Image Properties

When you select File -> Image Properties menu, the image properties dialog will appear. From this dialog, you can add or edit update center repository urls.

Replacing Community Repository Configuration with Sun Repository Configuration

In several upgrade scenario you may need to replace community distribution repository configuration with Sun branding repository configuration. Here are the steps:
1. Start Update Tool

  • Start update tool by going to top level "bin" directory and running "updatetool" script. The GUI should appear.

Cannot resolve external resource into attachment.

2. Set "release.glassfish.sun.com" as preferred publisher in Image Properties

  • On Update Tool menu, select File -> Image Properties...
    • This should bring up a dialog.
    • Select "Preferred" checkbox in "release.glassfish.sun.com" row in "Software Sources" table.
    • Click OK button.

Common Distribution Upgrade Scenarios

Upgrading to Sun GlassFish Enterprise Server v3

Using the Update Center, user is able to upgrade their community installation to Sun GlassFish Enterprise Server v3 installation. Use following steps:

1. Set Sun Repository

  • Replace community repository configuration with Sun repository configuration using these instructions.

2. Install Sun Distribution Artifacts

  • Go to "Available Add-Ons" screen and install one of these packages, depending on desired distribution profile:
    • GlassFish Enterprise Full Profile (glassfish-enterprise-full-profile) or
    • GlassFish Enterprise Web Profile (glassfish-enterprise-web-profile)

This will download the necessary artifacts and upgrade your installation.

3. Verifying the Upgrade

  • Congratulations! You are now using Sun GlassFish Enterprise Server v3.
    • You may run "asadmin version" command to verify the upgrade.
    • Alternatively, you may also log on to the management console and verify the version of the product on the masthead.

4. Going Back to Community Distribution

  • To undo the changes, simply remove all packages from this list listed in "Installed Components" screen:
    • glassfish-enterprise-full-profile
    • glassfish-enterprise-web-profile
    • glassfish-branding
    • glassfish-branding-gui
    • mq-branding

After server re-start, you should see the community distribution version.

Upgrading to Java EE 6 SDK

Using the Update Center, user is able to upgrade their community or Sun GlassFish Enterprise Server v3 installation to Java EE 6 SDK. Use following steps:

1. Set Sun Repository

  • If your starting point is community distribution installation, replace community repository configuration with Sun repository configuration using these instructions.

2. Install Java EE 6 SDK Distribution Artifacts

  • Go to "Available Add-Ons" screen and install one of these packages, depending on desired Java EE 6 SDK distribution profile:
    • Java EE 6 SDK Full Profile (javaee-sdk-full-profile) or
    • Java EE 6 SDK Web Profile (javaee-sdk-web-profile)

This will download all Java EE 6 SDK components and upgrade your installation to the equivalent of Java EE 6 SDK.

Upgrading From Community Web Profile to Community Full Profile

1. Install GlassFish Full Profile Artifacts

  • Go to "Available Add-Ons" screen and install following full profile metapackage:
    • GlassFish Full Profile (glassfish-full-profile)

This will download all required components and upgrade your installation to the equivalent of full profile GlassFish v3.

Upgrading From Sun GlassFish Enterprise Server Web Profile to Sun GlassFish Enterprise Server Full Profile

1. Install GlassFish Full Profile Artifacts

  • Go to "Available Add-Ons" screen and install following full profile metapackage:
    • GlassFish Enterprise Full Profile (glassfish-enterprise-full-profile)

This will download all required components and upgrade your installation to the equivalent of full profile Sun GlassFish Enterprise Server v3.

Upgrading From Java EE 6 SDK Web Profile to Java EE 6 SDK Full Profile

1. Install Java EE 6 SDK Full Profile Artifacts

  • Go to "Available Add-Ons" screen and install following full profile metapackage:
    • Java EE 6 SDK Full Profile (javaee-sdk-full-profile)

This will download all required components and upgrade your installation to the equivalent of full profile Java EE 6 SDK.

Setting Up Automatic Update Checks

To Schedule an update check:

  • Select the Preferences button.
  • In the Updates section of the dialog, select "Automatically check for updates" checkbox and set a desired frequency of update check.
  • Click OK button.

The Update Center notifier automatically checks for updates based on the schedule you defined in the Update Preferences. However, you can also check for an update at anytime using the Refresh button. If any updates become available, they are displayed in the Available Updates screen.
More components are being added every day, so check the Update Center frequently.



UpdatetoolBootstrap.GIF (image/gif)
PreferencesProxy.PNG (application/octet-stream)
ImageProperties.PNG (application/octet-stream)
UpdatetoolClient.PNG (application/octet-stream)