Upgrading to Oracle GlassFish Server From GlassFish Server Open Source Edition

Oracle provides software support only for Oracle GlassFish Server, not for GlassFish Server Open Source Edition. Additionally, some features of Oracle GlassFish Server are not available in GlassFish Server Open Source Edition.

If you are using GlassFish Server Open Source Edition, you can upgrade to Oracle GlassFish Server by purchasing a right-to-use and installing the add-on component for upgrading GlassFish Server Open Source Edition. To obtain this component, and to ensure the reliability of your upgraded installation, you must configure your GlassFish Server installation to obtain updates from the appropriate repositories.

To use Oracle GlassFish Server in production after the upgrade, you must obtain a right to use this software from Oracle.

You can upgrade to Oracle GlassFish Server by using either Update Tool or the pkg command.

To Upgrade to Oracle GlassFish Server by Using Update Tool

The procedure explains how to use Update Tool to obtain and install the add-on component for upgrading GlassFish Server Open Source Edition to Oracle GlassFish Server. For general instructions for using Update Tool, see the Update Tool online help.

Before You Begin

Ensure that GlassFish Server Open Source Edition 3.0.1 is installed on your machine.

1. Start Update Tool.

   as-install-parent/bin/updatetool

2. From the Application Images list, select GlassFish Server Open Source Edition.

3. Click Edit Properties.

   The Image Properties window opens.

4. (Optional) In the Image Properties window, change image title to Oracle GlassFish Server.

5. Remove the following publishers from the list of software sources for the image:

   • dev.glassfish.org

   • stable.glassfish.org

   • release.javaeesdk.sun.com

   Remove each publisher as follows:

   1. In the Image Properties window, select the publisher that you are removing.

   2. Click Remove.

6. Add repositories for Oracle GlassFish Server to the application image.

   Add each repository as follows:

   1. In the Image Properties window, click Add.

      The Publisher Properties window opens.

   2. In the Publisher Properties window, specify the properties of the repository that you are adding and click OK.

      The properties to specify for each repository are listed in the following table.

      Publisher Name	Repository URL
      release.glassfish.sun.com	http://pkg.sun.com/glassfish/v3/release/
      dev.glassfish.sun.com	http://pkg.sun.com/glassfish/v3/dev/

      For more information about these repositories, see Oracle GlassFish Server Repositories.

      The Publisher Properties window closes. The publisher is added to the Software Sources list in the Image Properties window.

7. In the Image Properties window, set the Preferred option for the release.glassfish.sun.com publisher and click OK.

   The Image Properties window closes.

8. Under GlassFish Server Open Source Edition in the Available Images list, select Available Add-ons.

9. Select the add-on component for upgrading the distribution of GlassFish Server Open Source Edition that is installed:

   • If the Web Profile distribution is installed, select the Oracle GlassFish Server Web Profile add-on component.

   • If the Full Platform distribution is installed, install the Oracle GlassFish Server Full Platform add-on component.

10. Click Install.

11. To apply your changes, restart GlassFish Server.

    See To Restart a Domain.

To Upgrade to Oracle GlassFish Server by Using the pkg Command

Before You Begin

Ensure that GlassFish Server Open Source Edition 3.0.1 is installed on your machine.

1. To ensure that the pkg command can locate the application image, change to the base installation directory for GlassFish Server.

   cd as-install

   as-install

   The base installation directory for GlassFish Server.

2. Remove the following publishers from the list of publishers for the image:

   • dev.glassfish.org

   • stable.glassfish.org

   • release.javaeesdk.sun.com

   pkg unset-publisher dev.glassfish.org stable.glassfish.org \ release.javaeesdk.sun.com

3. Add repositories for Oracle GlassFish Server to the application image.

   The properties to specify for each repository are listed in the following table.

   Publisher Name	Origin Uniform Resource Indentifier (URI)
   release.glassfish.sun.com	http://pkg.sun.com/glassfish/v3/release/
   dev.glassfish.sun.com	http://pkg.sun.com/glassfish/v3/dev/

   The publisher release.glassfish.sun.com must be the preferred publisher.

   For more information about these repositories, see Oracle GlassFish Server Repositories.

   1. Add the repository whose publisher is release.glassfish.sun.com, which must be the preferred publisher.

      pkg set-publisher -P -O http://pkg.sun.com/glassfish/v3/release/ \ release.glassfish.sun.com

   2. Add the repository whose publisher is dev.glassfish.sun.com.

      pkg set-publisher -O http://pkg.sun.com/glassfish/v3/dev/ \ dev.glassfish.sun.com

4. Install the add-on component for upgrading the distribution of GlassFish Server Open Source Edition that is installed:

   • If the Web Profile distribution is installed, install the Oracle GlassFish Server Web Profile add-on component.

     pkg install glassfish-enterprise-web-profile

   • If the Full Platform distribution is installed, install the Oracle GlassFish Server Full Platform add-on component.

     pkg install glassfish-enterprise-full-profile

5. To apply your changes, restart GlassFish Server.

   See To Restart a Domain.

See Also

For the full syntax and options of the pkg command, see the pkg(1) man page. This man page is installed only after the pkg utilities have been fully installed.

To view this man page on UNIX and Linux systems, type the following command in a terminal window:

man -M as-install-parent/pkg/man/ pkg

To view this man page on Windows systems, use the type command to view the file as-install-parent\pkg\man\cat1\pkg.1.