Updating Installed Components

This section provides the following instructions for updating GlassFish Server components after they have been installed:

• To Update an Installed Component

• To Update All Installed Components in an Image

To Update an Installed Component

When you install an updated version of a component, only those files that have been modified are downloaded and installed. Files that have been removed in the updated package are removed during the update process.

1. Stop GlassFish Server.

   See To Stop a Domain.

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

3. Obtain a list of only the installed packages that have available updates:

   pkg list -u

   Information similar to the following is displayed:

   NAME (AUTHORITY)                              VERSION         STATE      UFIX
   glassfish-ejb                                 3.0.1-14        installed  u---
   glassfish-hk2                                 3.0.1-14        installed  u---
   glassfish-jca                                 3.0.1-14        installed  u---
   glassfish-jcdi                                3.0.1-14        installed  u---
   glassfish-web                                 3.0.1-14        installed  u---
   glassfish-web-incorporation                   3.0.1-14        installed  u---
   glassfish-web-profile                         3.0.1-14        installed  u---
   jersey                                        1.1.5-1.0       installed  u---
   metro                                         2.0-29          installed  u---

4. Install a new version of a package.

   pkg install package-name

   For example:

   pkg install metro

   Information similar to the following is displayed:

   DOWNLOAD                                     PKGS       FILES     XFER (MB)
   Completed                                    1/1         5/5     0.49/0.49 
   
   PHASE                                        ACTIONS
   Removal Phase                                    2/2 
   Update Phase                                     7/7 
   Install Phase                                    2/2

5. Start GlassFish Server.

   See To Start 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.

To Update All Installed Components in an Image

GlassFish Server enables you to maintain multiple installation images on a single system. When you update an installation image, all the components that are present in that image are updated to new versions, if new versions are available. When you install updated versions of components, only those files that have been modified are downloaded and installed. Files that have been removed in the updated package are removed during the update process.

1. Stop GlassFish Server.

   See To Stop a Domain.

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

3. Install all packages for the image.

   pkg image-update

   Information similar to the following is displayed:

   DOWNLOAD                                     PKGS       FILES     XFER (MB)
   Completed                                    6/6     729/729   21.59/21.59 
   
   PHASE                                        ACTIONS
   
   Removal Phase                                887/887 
   Update Phase                                 253/253 
   Install Phase                                584/584 

4. Start GlassFish Server.

   See To Start 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.