Oracle GlassFish Server 3.0.1 Administration Guide

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