JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle GlassFish Server 3.1 Administration Guide
search filter icon
search icon

Document Information

Preface

1.  Overview of GlassFish Server Administration

Default Settings and Locations

Configuration Tasks

Administration Tools

Instructions for Administering GlassFish Server

Part I Runtime Administration

2.  General Administration

3.  Administering Domains

4.  Administering the Virtual Machine for the Java Platform

5.  Administering Thread Pools

6.  Administering Web Applications

7.  Administering the Logging Service

8.  Administering the Monitoring Service

9.  Writing and Running JavaScript Clients to Monitor GlassFish Server

10.  Administering Life Cycle Modules

11.  Extending and Updating GlassFish Server

About Add-On Components

Preconfigured Repositories for GlassFish Server

Oracle GlassFish Server Repositories

Enabling the Oracle GlassFish Server Support Repository

GlassFish Server Open Source Edition Repositories

Tools for Extending and Updating GlassFish Server

Update Tool

The pkg Command

Administration Console

Adding Components

To Install an Add-on Component

Updating Installed Components

To Update an Installed Component

To Update All Installed Components in an Image

Removing Installed Components

To Uninstall an Installed Component

To Uninstall and Revert to an Older Version of a Component

Upgrading to Oracle GlassFish Server From GlassFish Server Open Source Edition

To Upgrade to Oracle GlassFish Server by Using Update Tool

To Upgrade to Oracle GlassFish Server by Using the pkg Command

Extending and Updating GlassFish Server Inside a Closed Network

To Install the Pre-Installed Toolkit Image Inside a Closed Network

To Configure a Local Repository Server Inside a Closed Network

To Configure a GlassFish Server Installation to Use a Local Repository Server Inside a Closed Network

To Install Updates From a Local Repository

Part II Resources and Services Administration

12.  Administering Database Connectivity

13.  Administering EIS Connectivity

14.  Administering Internet Connectivity

15.  Administering the Object Request Broker (ORB)

16.  Administering the JavaMail Service

17.  Administering the Java Message Service (JMS)

18.  Administering the Java Naming and Directory Interface (JNDI) Service

19.  Administering Transactions

Part III Appendixes

A.  Subcommands for the asadmin Utility

Index

Preconfigured Repositories for GlassFish Server

Image Packaging System (IPS) tools for updating GlassFish Server software obtain updates from repositories that contain the OSGi modules and other content for GlassFish Server.

Oracle GlassFish Server and GlassFish Server Open Source Edition each have their own set of repositories, as explained in the following sections:

Oracle GlassFish Server Repositories

Table 11-1 lists the preconfigured repositories for Oracle GlassFish Server.

Table 11-1 Oracle GlassFish Server Preconfigured Repositories

Publisher
URL
Description
release.glassfish.oracle.com
pkg.oracle.com/glassfish/v3/release/
Commercial, production quality versions of the core components and add-on components of Oracle GlassFish Server
contrib.glassfish.oracle.com
pkg.oracle.com/glassfish/v3/contrib/
Additional add-on components that are contributed by Oracle partners
contrib.glassfish.org
pkg.glassfish.org/v3/contrib/
Additional add-on components that are contributed by the GlassFish community
dev.glassfish.oracle.com
pkg.oracle.com/glassfish/v3/dev/
Developmental, beta, and prerelease versions of the components in the pkg.oracle.com/glassfish/v3/release/ repository

For Oracle GlassFish Server installations, the release.glassfish.oracle.com publisher is designated as the preferred publisher. To ensure that installations contain only commercial, production quality version of components by default, the preferred publisher is treated specially by the tools for updating GlassFish Server software:

If you have support for Oracle GlassFish Server, you can change the preferred publisher's repository URL from the Oracle GlassFish Server release repository to the Oracle GlassFish Server support repository. For more information, see Enabling the Oracle GlassFish Server Support Repository.

Enabling the Oracle GlassFish Server Support Repository

If you have support for Oracle GlassFish Server, you can change the repository URL for the preferred provider, release.glassfish.oracle.com, to refer to the support repository instead of to the release repository. This support repository includes the content provided by the release repository, but also includes commercial, production quality updates that resolve issues reported by Oracle GlassFish Server customers.

Enabling the Oracle GlassFish Server support repository involves two tasks:

  1. Your company's technical contact acquires the key and certificate files needed to access the support repository.

  2. GlassFish Server administrators use the key and certificate files to change the release.glassfish.oracle.com publisher's repository URL to the support repository.


Note - The key and certificate files needed to enable access to the support repository expire. When they expire, you need to acquire new ones and apply them to your Oracle GlassFish Server installations.


To Acquire the Key and Certificate Files for the Support Repository

To acquire the key and certificate files for the Oracle GlassFish Server support repository, your company's technical contact uses the pkg-register.oracle.com Certificate Generator.

Before You Begin

Before using the Certificate Generator, you must add your Oracle GlassFish Server Customer Support Identification (CSI) numbers to your My Oracle Support account. If you do not yet have a My Oracle Support account, you can create one at https://support.oracle.com.

  1. In a web browser, go to https://pkg-register.oracle.com and sign in using your My Oracle Support account information.

    After signing in, the Certificate Requests page displays, showing “Oracle GlassFish Server 3 Support” as one of the products for which you can request a certificate.

  2. Select “Oracle GlassFish Server 3 Support” and then click Submit.

    The Certificate Requests: Additional Information page displays.

  3. Enter an optional comment if desired, and then click Submit.

    The Certificate Information page displays.

  4. Note down the expiration date of the certificate.

    When the current certificate expires, you will need to repeat this process to acquire new certificates.

  5. Click Download Key and save the Oracle_GlassFish_Server_3_Support.key.pem file.
  6. Click Download Certificate and save the Oracle_GlassFish_Server_3_Support.certificate.pem file.
  7. Sign out of the Certificate Generator site.
  8. Make the key and certificate files you saved available to your company's Oracle GlassFish Server administrators.

    Note - If you accidentally delete or misplace these files, you can sign into https://pkg-register.oracle.com using your My Oracle Support account information and get replacement copies of them.


To Change the release.glassfish.oracle.com Publisher's URL to the Support Repository

Use the pkg utility to change the repository URL for the release.glassfish.oracle.com publisher to the Oracle GlassFish Server support repository for an Oracle GlassFish Server installation.

Before You Begin

Before you use the pkg utility, you must copy the Oracle_GlassFish_Server_3_Support.key.pem key file and the Oracle_GlassFish_Server_3_Support.certificate.pem certificate file to a location accessible from the host where Oracle GlassFish Server is installed.

  1. On the host where Oracle GlassFish Server is installed, navigate to the parent installation directory:
    cd as-install-parent

    The default parent installation directory is glassfish3.

  2. Use the pkg set-publisher command to change the repository URL:
    • On Unix systems (including Mac OS), where backslash (\) is the command line continuation character:

      bin/pkg set-publisher -P \
      -k path-to-key-file/Oracle_GlassFish_Server_3_Support.key.pem \
      -c path-to-certificate-file/Oracle_GlassFish_Server_3_Support.certificate.pem \
      -O https://pkg.oracle.com/glassfish/v3/support release.glassfish.oracle.com
    • On Windows systems, where caret (^) is the command line continuation character:

      bin\pkg set-publisher -P ^
      -k path-to-key-file\Oracle_GlassFish_Server_3_Support.key.pem ^
      -c path-to-certificate-file\Oracle_GlassFish_Server_3_Support.certificate.pem ^
      -O https://pkg.oracle.com/glassfish/v3/support release.glassfish.oracle.com

GlassFish Server Open Source Edition Repositories

Table 11-2 lists the preconfigured repositories for GlassFish Server Open Source Edition.

Table 11-2 GlassFish Server Open Source Edition Preconfigured Repositories

Publisher
URL
Description
release.javaeesdk.oracle.com
pkg.sun.com/javaeesdk/6/release/
Production quality versions of the core components and add-on components of GlassFish Server Open Source Edition
stable.glassfish.org
pkg.glassfish.org/v3/stable/
Most current stable pre-release build of core and add-on components
contrib.glassfish.oracle.com
pkg.sun.com/glassfish/v3/contrib/
Additional add-on components that are contributed by Oracle partners
contrib.glassfish.org
pkg.glassfish.org/v3/contrib/
Additional add-on components that are contributed by the GlassFish community
dev.glassfish.org
pkg.glassfish.org/v3/dev/
Developmental, beta, and prerelease versions of the components in the pkg.sun.com/javaeesdk/6/release/ repository

For GlassFish Server Open Source Edition installations, stable.glassfish.org is the preferred publisher.